2a ihe 


«oy 6 
Ree ea} 


Cae, 
Leto 


SYSTEM V/68 Release 3 
Programmer's Reference Manual 


ee eek 
To aX 
seals eS Oe 


ann 
Penta 


Beh 


pete 


» 
te 


Phe, ie 
ye frcecye 
‘7 “ey 


panes 


rs 

: Soe 
REN 
ae 


Te" 7 


ERE 


he A Bate Se! 


SSR 


MU43814PR/D2 


a3 & ene : ¥ ae ete 
. RA Ge AOE wee tet ik Pe SR ee Ee 
Be pg te & ‘ © a Ok fs ee cds ge tee Sa’ € 


PBA ee A 
re 


oyts . 
9 ORF 


Se: tepran . « ae ; a 
eg Me, — ay ene 


SYSTEM V/68 RELEASE 3 
PROGRAMMER’S REFERENCE MANUAL 


Part Number MU43814PR/D2 


Version 2 


SYSTEM V/68™ is a trademark of Motorola Inc. Dataphone®, Teletype®, and 
UNIX® are registered trademarks of AT&T. Diablo® is a registered trademark of 
Xerox. HP™ is a trademark of Hewlett-Packard. PDP™, VAX™, and DEC™ are 
trademarks of Digital Equipment Corporation. TEKTRONIX® is a registered 
trademark of Tektronix, Inc. TermiNet™ is a trademark of General Electric. 
Versatec® is a registered trademark of Versatec Corporation. C-68000™ is a 
trademark of Green Hills Software, Inc. 


SYSTEM V/68 Release 3 is based on the AT&T UNIX System V, Release 3.0. The 
software described herein is furnished under a licensed agreement and may be 
used only in accordance with the terms of the agreement. 


Copyright © 1986, 1987 Motorola Inc. All rights reserved. No part of this manual 
may be reproduced, transmitted, transcribed, stored ‘in a retrieval system, or 
translated into any language or computer language, in any form or by any means, 
without the prior written permission of Motorola Inc. 


Portions of this document are reprinted from 
copyrighted documents by permission of AT&T, 1986. 


(MA) MOTOROLA 


Part Number: MU43814PR/A1 


DOCUMENT SUPPLEMENT 


Date: 06/01/88 


The attached pages constitute the first revision to the SYSTEM V/68 Release 3 
Programmer's Reference Manual (Part Number MU43814PR/D2). This supplement is 
required to support the SYSTEM V/68 assembler (as) and the SYSTEM/V68 C 
compiler on the MC68030 microprocessor. It is also required for the Board 
Software Extension packages (BS82, BS83) on SYSTEM V/68 Release 3, Version 4. 
Additionally, corrections are included for dial and dfile. 


‘Please replace and add pages according to the following table: 


ar(1) 3/as(1) 1 

as(1) 2/3 

cc(1) 4/5 

gec(1) 1/2 

sysfs(2) 2/sysm68k(2) 1 
sysm68k(2) 2-4/5 
dial(3c) 1/2 

“|. dfile(4) 5/6 


"Replace old 


ar(1) 3/as(1) 1 
as(1) 2/blank 
|, cc(1).4/5 
gcc(1) 1/2 
sysfs(2) 2/sysm68k(2) 1 
| sysm68k(2) 2-4/blank 
dial(3c) 1/2 
dfile(4) 5/dir(4) 1 


sysm68k(2) 6/7 


dir(4) 1/dirent(4) 1 


e A vertical bar in the outside margin of a revised page indicates a text change or 
addition. | 


e A double asterisk (**) in the same position indicates a text deletion. 


10081 PRINTED INUSA 6-88 -IRONWOOD LITHO 5383-B 1,500 


PREFACE 


The Programmer's Reference Manual (Part Number MU43814PR/D2) describes the 
commands, function calls, file formats and miscellaneous facilities of interest 
primarily to programmers on the Motorola VME-based computer. 


While reasonable efforts have been made to assure the accuracy of this document, 
Motorola assumes no liability resulting from any omissions in this document or 
from the use of the information obtained therein. Motorola reserves the right to 
revise this document and to make changes from time to time in its content 
without being obligated to notify any person of such revision or changes. 
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SOUS (GS) sec canicaterlesades caste ansdestdnatnsvoasebieioeaienagentiadssa saanaeeuayeontoss .. get a string from a stream 
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BOEIE(SS) i cicie tava cits tite nineoncsdaa ton tetnanaiaestaalsaanmaieceaietarian ian asvenstencens access utmp file entry 


SCA LCIN OG) issns en ocractaceeccsancuetta to eaceancnnsaiaseodm eaten onictacean manage hash search tables 
Lt ONC)  wiielaws cxscinves inawsusasautareioetasassceuenss convert between 3-byte integers and long integers 
TOGK ESO eetscis sips acvcacgaameaeanca khan corsa ceeanandtaap en ats somaessbans ied seine tes record locking on files 
Search (GO) «cei conseusinactessitairctanss tncasiensaaarterspeetenaed cuptan tasantsadsevecceudens linear search and update 
MALOC(SE )  easecdaie casatees et eias veces ae seaas ate thems aeehiaeed a aadeeuansnenl nedeseoniouse main memory allocator 
IMEMIOLY (SO) iss hliateepawtevsaias Seasoad Gaiam iad eds et acanee a ie tmnadeaasss eum ante enaee: memory operations 
IMREEM DOC )  csssnsiemiciavansstieeyeaouiuicaesacucvenagnaeatdanieeerba enon auosatleats ocadetaes make a unique file name 
MONITOR (SO) sda yesset ih cctpenesieaeaardece st adepmeasa ear ieiet in gree ace aerate prepare execution profile 
PUIS ESC) coerce at aiaeiciadencosin co wet emton arenes eee get entries from name list 
PORTOR (SO) dis sas craea seas acssicpas ese nideueua bao McadaenieSpuen anies mmssnemaneales system error messages 
POPOM (99) gespesetewsesnenaus tga dsacaiaacusbsaniasbaemetioawnemaclavagaaadoeatsan initiate pipe to/from a process 
DENUE (GS) sista eutewinanimraysausaceaiaten san sgensesnnaahestanancadedrasvageeerettverenwaaant print formatted output 
DULG (G9) jodiegnl sarees hie eat ene eeriae bee put character or word on a stream 
PULCNIV (SO) ss ice had attoiierte instill adem emmsermar en ages change or add value to environment 
Putpwent (SC) scccwcciierecssceadevssenes bSatasyete shaiatse endian tauks badeusssuanns write password file entry 
PUES SO): sess xcaptiwah anna vindayesaddbeannasnnsausaconeroulaneuniautens iss saavesenenanesssane put a string on a stream 
GSOTU(SG ). sisaicease eearee peice en siete acne book oarsanb autem sapa swaataaccmacane ea ceteauaan st siesheaunneadents quicker sort 
Tali (BC) i aiaohspsenarasaisesawne sia viianvcdeoeaseeratass simple random-number generator 
SCAM ESS) ens betaaesisaascrcndacacanieha saiaties wasn stinstacawaak doneeaanan Dasa aaa tamanaanende ite convert formatted input 
SCEDUL (GS) ss soucs wironnnernailanatandrer ya tiabraeiiach henamnnasiacehamamanen teat assign buffering to a stream 
SEU MUP (SE) vnsricss teckoasasedaaas ies dancanwanipaacanten bpaansburnese tec sautuasndlersraiulaciccbaaeaiioes non-local goto 
SICED (BC) nriadinceitenenchacteinetuamteneeane ama uarnsnnee mete suspend execution for interval 
SSip tial (SC) eateniuadactara dees sncnacceinnhinsaptsmatduaa it aian ednecedepcenina casei astvyanancenoteauaiies software signals 
StIO (SS) scatiivananceatienehsetiaeii ted tminaneemsensmacunntsan standard buffered input/output package 
SEGIDC (SC) esdsccenakresnaiaoteennsecenniaseusecmaaeeeanenaese standard interprocess communication package 
SUING (SG) 2p sais eaasieas cise cancaie ies dada syed dnc sauna aaa va daancanew ata sigueemiacsanastaubones string operations 
SECO SC J chs hs ancralweiacnneniaeaiabinaacetanceastanesnepanaes convert string to double-precision number 
SELTON(SC ): inch scaectantwoimwaraus des encinbcw sander hucnawies anduayiacvadocnesnninetaeniaveenaees convert string to integer 
SW 0 (GC) rs cis saocccunnvacaasoncnseae si sntdanwsnnccadtuteuie opnimbaagbaatis once Gaeatstaas iasseletsotiaee esas: swap bytes 
SYSLEMI (SS). eaccesiskda sath aasanistvysiuatncunensaear evan ne tiuin id eumanselapiddonies eiueeats issue a shell command 
TPIS (35 yr sss cect arias treet sec eet anc set ay ews tes olondawedsansennerasbaauetnceneRadaadoeetbaues create a temporary file 
HN PNAIN (5S) seeks antinisstuse ee aot vanssnebaplanen hyasedihan create a name for a temporary file 
tSCar Cin (SC) say wicceseaisaecesdauracSovosnmeuana ina aaad bed naeedea basasionmatensien died: manage binary search trees 
TY NAINEC (SC) ic css carlicsttng shud datcgatssanctoneasasonndadvann sbinaduareiadeaneatenaesbsnacadess find name of a terminal 
LLY SIOE( SO io ccsceaccctaesCatepenceathisciowasapatlttdamanss find the slot in the utmp file of the current user 
LING CLE (35) ac tiieas cia odtsneacnn pevenasanesenaese aneerunranranaustaien push character back into input stream 
WPTIAth (SS) iss ticts tet cridsadi es sidaraateidepaynties print formatted output of a varargs argument list 
DeSSCLGN)) scccrsisunesa Rictissericiatind ainieadectersaisances ial ausseasaanenawacciaa Recaesnauisevanlacee' Bessel functions 
CH(GM) esi cahicimewtdntd omaha error function and complementary error function 
OXDIOM)  ciseacntcmn ease tismnuariests aettetuentys exponential, logarithm, power, square root functions 
POOP (SM) cis siseaectiecentem atic ateahisealaaus floor, ceiling, remainder, absolute value functions 
Patina (SIV) ssisocd ss tenitestewsaiaasasasacorcnsssnsda tua suetsvatenaie mac teemcuew sees Gave aia log gamma function 


MU43814PR/D2 - ix- 12/01/87 


FIV DOCCOM) x viiisscicascovtntusa na ceaseat sgncandnre, Cue hitaasi iat tances ete ataecawtedneets Euclidean distance function 


miathSSl (SM): citceastcessesce staal actsiaesw arate Minadin oa ad vabeee reac senriedeaans floating point math functions 
Iathere (GM) siisssnatetsncsbanssaceasesaiaoencesuietescassneteaisetatinessSeasameaeenetea saat error-handling function 
BUN (SM) cscad ate erussicsancasys sxiviatuscssttennceaiacctern ap aveisuennisenst deanna eaaeeseeeas hyperbolic functions 
CLS (OM). sessssaau ante siiessagutnansseanwendin eeectsaataiuginaihssbavemaaianscnaaeseestaniads trigonometric functions 
TSACCODE (SIN) erase acca cher da eats as aeaeo es eee eran ea vanontnans accept a connect request 
PANOG(ON) ise c, ecsetepstetsterictaateta cacao eteeesanctumisendiShawniwaden mae allocate a library structure 
€ DING (GN) acasee cio nisters ntyistideienaloavzinns satan mreera tater bind an address to a transport endpoint 
tClOSE(GN )) wiscjnassctetie cee aceeeeat ose aie cee ees close a transport endpoint 
tZCONNECE(GN):. 2idicscscwenastnGncsdeornouceereides establish a connection with another transport user 
£-Orror( SIN) shi saiviweianseaadantehaniotiacdea lenes tena totdeceuiaeeti ined ones produce error message 
ft PRECCAN). Sssstiaiads cated ermeeeacerdgcarcesanencseacc snacasac eden cs asso eatin eee ree free a library structure 
tipetinio(ON): sosiicwiscdiga vied earanen seam aysetions get protocol-specific service information 
t -POtStale( SIN) cedcsmicssscinaseseccense ye macintens teceewalasvingsteacetess dau eeweaioawians eats get the current state 
toTiSter (SIN) -sscisavetavand ste ieavecsanasdcsacs Watsar Gana ws cain eoetinamiie ante tiensatas. listen for a connect request 
tLOOKION) tcicsdSvaedeniticeos dan tesaencsanstenenoaviane: look at the current event on a transport endpoint 
£ CODEN OIN) ciceicgciscronce ea ecces te eaaas ea weiccptaen iota secdicawoeeaatanedsboanerns establish a transport endpoint 
£ Optmie nt (GN) ssgscdrnc vss actaecsstyasessicdns viatesencssmmaaatiead manage options for a transport endpoint 
PTC V (GIN sens cetereutt tentseceeenadtiytnas ease receive data or expedited data sent over a connection 
t-reveonnect (ON )) e.iviscocvienwcnashaiovancsvanstiols receive the confirmation from a connect request 
LTCVdIS (SIN) ei aiicnrsctinr tiesto ahora asi emai retrieve information from disconnect 
LTCVICU(GN) sesierecccicariestsvenaetencnceosetes acknowledge receipt of an orderly release indication 
ETEVUCA AC OIN) Siesta cna casticescadstuncteadensanstatceaded seadasea toe taaaBoatesedieasrabertaootaea eens receive a data unit 
TETCVUGErE (GIN) erecirosa i onesndieenanten aaa uv caweamamncesa anaes receive a unit data error indication 
tSNGCGN )\. detanat set seaeeaielieitiaee Oa utesete tee tee send data or expedited data over a connection 
tSNAGIS (GIN) psxoa Gal tronsnipescstioi ne toe emniiaeters send user-initiated disconnect request 
BASTIGTOM ON)? io soviaaahaaatcar eeu gins siavmgte dancers audeeamaatantadenaeess ee initiate an orderly release 
t_sndudata(3N) ............ceeeeeees ssibian Siepindibalnltd be Niaa tote dlesbite tah enns aaamonmusseecoamieawitices send a data unit 
TOS MC(GOIN) os sasrcsass rea tibasornsaucatnresiat auebepsaaunia niin tnaene esetaanedes synchronize transport library 
te DUNA CON) airatiues scautee rcp aacenau et anil Paced notip ne oatavepieadeasiceacseensos disable a transport endpoint 
DSSETL(ON) : Sasscacnssndaynassadasiovetandutanduatoangioaun mietaaalsccaseeeaedadevetteN cts verify program assertion 
CEYPUOX ) as sistinacnotipenshueavaeersersnic een awean eb ean onasiate: password and file encryption functions 
CUTSCS(ON) sistas dsictonsayceviweneaemanens terminal screen handling and optimization package 
GIFECTOLY (GX) ueiiaicad stint Sas siasiuadrest en omaddcarsuatettusiouedsnuees atmdemuanyharsawets directory operations 
REMUIN (SA) csicsnseitei cae Gucsseracs contac seat ie eae sea tuaus ee calculate an integer value from a string 
POIDEHING IN) Aicsiicncceess tenaniansaveaauaia sadsossn liu taawuuasieaiseydenndesy teeeddeabe dandy: read the permissions file 
IGanreaG (SX): sc.vecsasieeebetawnesiestigssss read the archive header of a member of an archive file 
LACIOSE(SX)). nnetdt et sncedateaceasec tansauemnnaseeain Seeder ae kab dnatecodeceaniuaioeatate close a common object file 
Id fhireaGg (SX) siesdierceioastes ect Maciel ctaus Ueadlot, read the file header of a common object file 
Idgetname (3X) .............06. retrieve symbol name for common object file symbol table entry 
Idlread (3X) .......cccceeeeeees manipulate line number entries of a common object file function 
Idiseek (3X). iccissniisictesincsaeiese seek to line number entries of a section of a common object file 
IGONSECK (SX): cosssdescndesesadodeceets Ocoee! seek to the optional file header of a common object file 
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LAO PON (SX) ceasasiectesasewtenvarsamsipncsiowtalastammuiinieenicetes open a common object file for reading 


Idrseek (SX) scsi nsidictacicaeascene seek to relocation entries of a section of a common object file 
Idshread (3X) ............ecceeee ees read an indexed/named section header of a common object file 
Idsseek (3X) ictus cxeatereecseseedecoerwans seek to an indexed/named section of a common object file 
Idtbindex(3X) ......... compute the index of a symbol table entry of a common object file 
Idtbread (3X) sectcdssntnapeces read an indexed symbol table entry of a common object file 
IdtbS€@K (3X) setsav ec dissaicienceeetaneeciesstaigssods seek to the symbol table of a common object file 
OBTAINS (OX) ss acialeansis eames taeda da cons aera enesdane cen timnaadeemameedecenrsesteseten return login name of user 
PAMOC(AX ) i paatee ti caeites Gade ataancuecuamiea ve usen a Mnsauskelaaauteenenteuss fast main memory allocator 
PER CIND (3X) iasctinnassh Sex statics Giadencates loseecrenteelnteenioons compile and execute regular expression 
SPULl (GA) sxsatsvisssanecsscctsnetedsduocaws access long integer data in a machine-independent fashion 


4. File Formats 


WTOC) iasacnaoion Gas inbenaindiehonce so enee tenes seoae serena eouwancactinngpios introduction to file formats 
ACOUL(A) aissusie vevieeas wires wenisase re bteeeessvecesas common assembler and link editor output 
ACCE(A) + siyactoian Aaah soeae Mange waeraenerakes amen sneenaeres per-process accounting file format 
BEA) esceceioanss naw etet etalon esata casedccate beamed ed ocsete common archive file format 
checklist (4). sasisiciyncneesusvess tinSeteaeraaees list of file systems processed by fsck and ncheck 
COVE(A). ccGoesdrddeisestesueen esata wis ies cehataeumamnneeetiemceenes format of core image file 
CIO (4) wolicdeceiciet sedis ten ien saveausaemmeey tie enbombeiennetsereuscesaereniseus format of cpio archive 
file (AY ic ic icant et seetrica ee podies Sewanee weaoarretnaae eee eumceay coage device information file 
Gin (4): seticnihosrea we dorevdecais cuiudientes rawaroeese es manaraaeeseeadsseanuneerds format of directories 
Girent (4) ssicnnciwe dasicadsa be steaseveatarnc ie esiatenstancs file system independent directory entry 
StrMe (4), este aceacmesanawsstccaee canteen hie Scenes qa iawn aies Suassmceme nee aaa’: error-log file format 
PICNGE(A): ccisienGeredcoedsicerene tls teeta tee tin.aedanascorees file header for common object files 
£9 (4), ehowseetescreitexetacsud an eteancen ocd gs unaciotans anaemia tesane eset format of system volume 
FSPOEC(4) -sscauaidtete nace sacsmetieaua cba yi sagsenecaddentinetusmeeswees format specification in text files 
ES GAD (4): tees cectiosciowmaien vos ens cues au en oten tonal eenenenn steer aeteuse taal vaeseaneawens file-system-table 
petty dels (4) os.c dssswessisatprer aware osdemahebsaptye speed and terminal settings used by getty 
BLOUD 4 )iwxcwescdubseadvsekaeiew spss tinadsuaedd ioicaue Mearens bean messsmemsnoyeseboeeanteds group file 
NOSEA) ccssrecasseniceveretecnaaaies wats ciieewyeiehesauas etvane sn tuanence mene cnues system host name 
NOSIS (4) .uiniancdceataaiseabammnsacs sotiiscuses suelo rcbaatereaieane heated eeeeewes host name data base 
NOStSLeQUIV (4) esieienrseseessevictbessbentiises uisescncaes names of hosts with "equivalent" users 
initlab (4) \scscocnatuaseeedeadsahiwanecsowantn cbianMnaedeaehausleamaoees aye una script for the init process 
POE (4) ais cctscsoasomsicmmseicce seeds ceseeois Seton alantauneneneueeend teounnsee. format of an i-node 
ISSUE (4) spe ores Vacdutome tb gaveden teeta canescens inn iann sad eeu eeeaeteees issue identification file 
LOLCI (4) snptcnensnateseicsuedniennseaieedeecoguseseteeoiaesh nas common object file access routines 
HOMtS (A): c2o.cecnedatsewnigueiewnden. sans eadeoae file header for implementation-specific constants 
lin@numi (4) -sieceiswasveccoaiccsnsencsiaseeetaadet ates. line number entries in a common object file 
TNASTOR (4): csncnincedtarutenswasetisiestevsecienrs akbet uaviessseuemeaate master configuration database 
MUNA (4) a ie nah eantytdne seas cesta al dcone mane acemmoe seen tedoats mounted file system table 
PASS WA)! scene Aeeaesicdates da sciade sania tianaameloaonoandan nas teasee neeuewiaer see neiee password file 
POPS): ecstersiesnioctwnicecons permissions file used by the value-added disk access utilities 
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Profile (4): scan caxsiassacwscretacsesiecasnentccsatoaenaseas setting up an environment at login time 


Protocols (4), sevsvswdcoswistncav acer sdnsseee ccaaemoeseweteee UooesGesneestes protocol name data base 
CElOC(S) orccwles erst etoeiisecerniorisdieies relocation information for a common object file 
Pimaster (4) -scacveces cece veacensvestncataianpeeeederis Remote File Sharing name server master file 
PHOSISA): cscviatacnducouesriacarsosweeeeunessouies user-specified file of equivalent hosts and users 
SOCSINIC(4)’ soeciccceise ls alicia ucudistanaisey een esatniwan stand ane sneaaita snmouese meine format of SCCS file 
BCHINGEGA) sss eictetocdaanenetasyaseaseedansssaveennmceuameusueuaneas section header for a common object file 
SCP AMIN (4). eidasceeacedvirsremmsedernsnavadaeaostedonnanteneeuaeaatentians format of curses screen image file 
BEFVICES (4) gsisl sacar stetndae aes inc oat ve dean d antoaanateatees ese taceaepaoee se snatsiees service name data base 
SVS (4): cists de sndn ws saakdvecs pannancupnnesananssesnicarsstieertencinness common object file symbol table format 
COPING) | vara donivcwmndaicadenrarsncesanadsnewdecnatyacagusiaelacsarsmlelssoeseensenaetot format of compiled term file 
ferminfO(S): cuimeslaune. pesaasts cata Gane mneiite eines terminal capability data base 
{IME ZONE (A)! sca ideeieseiscietee srs etc sarenanesena te iausewianeacapaassumee seaweeds set default system time zone 
UNISt (4) cxettssncettenasestea shaman ameaerererentnarsaauuaee file header for symbolic constants 
EID (4) ecoschen ce siepeadtictactaceiteh Girteacicr eben ws utmp and wtmp entry formats 


5. Miscellaneous Facilities 


ENNETO (CD), ‘aaiticuiveasc sisi sieleda saw na dee mousing owen neem uaeseceagtanseenacesee cee introduction to miscellany 
ASCI(D): usb ocdasneahondswanedsameserewemstuaens tlio hadunaua vanes ames niin. map of ASCII character set 
GN VIFON (9) deacaricesasacearetunessaeiateaciactavaeantateoas vere radeuee i auaancateeten ier eeetvad eae user environment 
LOTAEL(D)) sexteg ict ete Secesiedecten hous nan antads ockditiscialanssuaasnetshsaateudideieesseceerine seals file control options 
_ NALIN) sidoasdcssaaenecnrtca dostarconemdnctensacsaitagehseasdnanmenicnmnuatiens math functions and constants 
DEOL (DO)! thsssicsssscustas sectantivinug cade ae sasuicpiee a saciaagunamsaumsedadessngnetieipoan bacaneannas profile within a function 
LEGEND) -dasincaisncanss soesesreutmrtentosaiannsyeeasaews regular expression compile and match routines 
SEAE(D) cc Gneidatncersesantay aa arunmennun si tovteacenbenmaapaphanerved cadaneidnkds data returned by stat system call 
TOPIN(D) cenccscataian ca asseacinescaeneep naa ticel seme e tice nwnvecdaaaaes conventional names for terminals 
EV PES (D) ceniticaceris des aupsheaeciispasitcon lonenmianinsdenin ab iuadegeeeas anes teaee primitive system data types 
WAINES (5) aisowcscvcnsnenstoeasieaemoanansa taal dnasbsedasan ade dasapenduawsesbaontecadbiedes machine-dependent values 
VALALPS(D) consi stesacecs aisenunssn cocuse.vetnvativanes visas iestade Sunt aecsiectneays handle variable argument list 
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